home *** CD-ROM | disk | FTP | other *** search
/ CICA 1993 April / CICA MS Windows - April 1993.iso / unzipped / util / tw112 / twman.doc < prev    next >
Text File  |  1992-11-04  |  14KB  |  294 lines
  1.  Text Watch V1.10
  2.  
  3.  Thanks to Bob Ostrander from PBS for his good suggestions.
  4.  
  5.  INSTALLATION:
  6.  Run Install before using TW and TWE. After running Install both TWE.EXE
  7.  and TW.EXE may be copied to any directory. It is recommended that the
  8.  directory TW.EXE and TWE.EXE are in be included in your DOS PATH.
  9.  
  10.  GENERAL INFO:
  11.  Text Watch (TW) will monitor your Text.INI file for changes and keep a
  12.  history of this changes stored in a seperate file.
  13.  
  14.  To make Text Watch simple, there are two types of changes that are
  15.  recorded, Addtions and Deletions. Lines which have been edited will be
  16.  reported as Deleted and Added, its not a bug. In fact if you think about
  17.  it, you will understand why an edited change is recorded twice. Text Watch
  18.  has a limit of about 51K size ASCII files. Text Watch is intented for
  19.  configuration type text files and has the following limitations which may be
  20.  adjusted as demand requires:
  21.  
  22. 1. Blank lines                        (TW will remove blank lines when reset)
  23. 2. Lines greater than 80 characters   (Line is truncated to 80 characters)
  24. 3. Files Greater than 640 lines       (TW will not process, TWE will truncate
  25.                                        file in memory, not on disk unless it is
  26.                                        saved)
  27.  
  28.  Text Watch or TW will monitor other files besides your WIN.INI
  29.  file, but WIN.INI is the default if no name is supplied at the
  30.  command line. When an option has been selected which can change
  31.  or remove stuff, a confirmation prompt will be displayed asking
  32.  you if you are sure (EXCEPT if you use /B). Think before selecting
  33.  Yes or using the /B option.
  34.  
  35.  Below is a list of TW critical files that TW creates for each Watch
  36.  file. You should not erase any of them (with the exception of *.TW)
  37.  if you wish TW to operate properly :
  38.  
  39.    The Watch Filename    ->     WIN.INI      or anyfile
  40.  
  41.    TW Creates:
  42.  
  43.    The Original Backup   ->     WIN.TW       or anyfile.TW
  44. *  The Last Change File  ->     L_WIN.TWL    or L_anyfile.TWL
  45. *  The History File      ->     WIN.TWH      or anyfile.TWH
  46.  
  47.  Files with a * next to them are hidden from a normal directory search.
  48.  
  49.  
  50.  The Watch File (any ASCII Text file):
  51.  This is the file which you wish to Watch for changes.
  52.  
  53.  The Original Backup:
  54.  This file is created by TW the first time the file is monitored so
  55.  that if total disaster strikes. You can resort back the original.
  56.  If you delete this file, TW will make another *.TW file of the
  57.  current file. (its better to just leave this file alone)
  58.  
  59.  The Last Change File (L_*.TWL):
  60.  This file is compared with the Watch File for changes. First the
  61.  file sizes are checked, then the file date and time are compared.
  62.  If any of these do not compare TW assumes the Watch File has been
  63.  changed and begins comparing the Last Change File and the Watch
  64.  file for Additions and Deletions. The results are stored in the
  65.  *.TWH file or History file. The Last Change File is then updated to
  66.  match the Watch file. If you delete this file or TW cannot find it
  67.  in the current directory, TW will assume it hasn't been run on this
  68.  file and Enable itself. This file is by default, always hidden from
  69.  view unless option /U is used.
  70.  
  71.  The History File (*.TWH):
  72.  This file keeps a running list of changes to the Watch file and
  73.  includes the Date and Time of the change and the actual changes.
  74.  This file is by default, always hidden from view unless option /U
  75.  is used.
  76.  
  77.   CAUTION: Be very careful if you decide to edit your history file.
  78.            Incorrect changes to you History file can lead to unexpected
  79.            results or lost data in the file when you run TW. See your
  80.            registered user Manual for History file formats.
  81.  
  82.  
  83.  TW.EXE (Text Watch)
  84.  For best use, install TW.EXE and TWE.EXE in a directory that is included
  85.  in your search PATH.
  86.  
  87.  TW is run from the command line or from TWE  before a file may be modified
  88.  and then after at some point. The best way to use TW is in a Batch file,
  89.  such as a WINDOWS.BAT with the command:
  90.                          WIN
  91.                          TW *.INI   <-- This will check all INI files
  92.  When you exit Windows you will be notified if thess files have changed, and
  93.  what was changed.
  94.  
  95.  The TW Text Watch Status line comment meanings:
  96.  
  97.  (ENABLED)          = Text Watch has set this file up to be watched
  98.  (DISABLED)         = Text Watch has removed its files. File is not setup to
  99.                       be watched.
  100.  (OPTIMIZED n)      = n Blank or Empty lines were removed from file.
  101.  (UPDATED)          = History and Last Change File updated with new changes.
  102.  (REVERSED)         = Last changes to file have been reversed
  103.  (CONFLICT CHECK)   = See Option /1
  104.  
  105.  (CHANGES Detected)      = Changes found in file since last checked.
  106.  (NO CHANGES Detected)   = No changes found in file since last checked.
  107.  
  108.  
  109.  TW has the following usage format:  (Each option is seperated by a space)
  110.  
  111.  Descriptions followed by an * indicate a confirmation prompt is displayed
  112.  asking you if you are sure before the action is executed unless the /B
  113.  option was used.
  114.  
  115.         TW FileSpec <Options>
  116.  
  117.         Options:  /B  = Bypass Confirmation prompt.
  118.                         Using this option will cause all Are You Sure
  119.                         prompts to bypassed as if Yes were selected.
  120.                         Careful here, this used in combination with the
  121.                         /C or /E switch could be trouble.
  122.  
  123.                   /C  = Clear History File and Settings (Reset)
  124.                         Wipes out any entries in your history file.
  125.                         Sets files as if it were the first time TW was
  126.                         run on the selected filespec.*
  127.  
  128.                   /D  = Do Not make *.TW file (ie. Original Backup)
  129.                         Do not make a backup copy of this file before
  130.                         Resetting file Information. This option should
  131.                         be included each time TW is run if you do not
  132.                         wish a *.TW file to be created.
  133.                         CAUTION: It is recommended  you do Not use this
  134.                                  option unless you are an experienced
  135.                                  user.
  136.  
  137.                   /E  = Erase TW watch files in directory. Any FileSpec
  138.                         entered is disregarded, so be careful if you
  139.                         use the /B option or all TW files in the directory
  140.                         will be removed. *
  141.                         (TW Files: anyfile.TW, anyfile.TWL, and anyfile.TWH)
  142.  
  143.                   /L  = Reverse Last Change in History File
  144.                         Restore the last change in your history file to
  145.                         your Watch file.*
  146.  
  147.                   /P  = Pause before exiting TW.
  148.                         Its good to use this switch when running from TWE.
  149.                         TW will pause with a 'Press any key' message before
  150.                         returning to TWE or DOS
  151.  
  152.                   /R  = Reverse any New changes.
  153.                         Automatically will restore this file to old copy
  154.                         whenever a new change is detected.*
  155.  
  156.                   /S  = Display any Changes on Screen.
  157.                         Display the text that was changed on the screen.
  158.                         Show added and deleted text.
  159.  
  160.                   /T  = Show all History files that TW is using in the
  161.                         selected directory. Any FileSpec entered is
  162.                         disregarded and all TW History files are listed.
  163.  
  164.                   /U  = Do not Hide or Unhide TW watch files. Must be
  165.                         used each time TW is run to keep these files
  166.                         unhidden.
  167.  
  168.                   /1  = Check for filename conflicts (ie. SYSTEM.INI and
  169.                         SYSTEM.BAT in same directory) in current directory
  170.                         using FileSpec. If any conflict is found TW will
  171.                         exit to DOS after displaying files which may
  172.                         conflict and the message (CONFLICT DISCOVERED),
  173.                         otherwise (NO CONFLICT FOUND) will be displayed
  174.                         TW will continue. This switch is only useful when
  175.                         DOS wildcards are used for the FileSpec.
  176.  
  177.  
  178.  
  179.  I like to use the following command line for my INI files:
  180.  
  181.    TW *.INI /P /S
  182.  
  183.  This will check (or the first time, reset) all my INI files, Display
  184.  a list of changes, if any, and Pause before exiting to TWE or DOS.
  185.  This is the best option to use for Windows. If you restore one INI
  186.  file that has changed you should also restore your other INI files
  187.  which have also changed.
  188.  
  189.  TW C:\WINDOWS\*.INI /R     Will reverse any changes it finds in your
  190.                             INI files.
  191.  
  192.  TW C:\WINDOWS\*.INI /L     Will reverse the last changes that were
  193.                             recorded in the INI files History File.
  194.  
  195.  TW C:\WINDOWS\*.INI /L /B  Will perform the same operation as above with
  196.                             no confirmation prompt.
  197.  
  198.  NOTE: TW and TWE do not process Blank lines. In fact, blank lines in
  199.        your INI files make Windows startup slower. Text Watch (TW.EXE) will
  200.        remove Blank lines when a history file is reset. See  (OPTIMIZED)
  201.        under Text Watch Status.
  202.  
  203.  
  204.  CAUTION:
  205.         Be careful when using wildcards in the FileSpec because
  206.         files which aren't true ASCII text files will be processed
  207.         incorrectly. If you do use TW on a binary file restore the
  208.         *.TW (ie. Original Backup) Also, as an added safety feature
  209.         TW will Not process (Watch) files with the extensions:
  210.  
  211.         *.TW   *.TWH  *.TWL  *.COM  *.EXE  *.OBJ  *.PIF  *.DLL
  212.         *.GRP  *.PCX  *.OVL  *.BMP  *.GIF  *.PIC  *.BIN
  213.  
  214.         It is not safe to use the filespec *.* since some files may not
  215.         be ASCII and have different extensions than those listed above.
  216.  
  217.  
  218.  
  219.  TWE.EXE (Text Watch Editor V1.12)
  220.  
  221.  Usage:  TWE <filename>
  222.  
  223.  TWE allows you to edit any text files that are 640 lines or less. (the
  224.  limit for TW as well, which is about 51K) You can also run TW from within
  225.  TWE and restore selected last changes. TWE is alot more powerful (and more
  226.  dangerous) than TW and allows for reverse to anywhere in your history file.
  227.  Below is a listing of keys available in the editor and short descriptions of
  228.  their functions. The TW Editor is compatible with WIN.INI files. To load a
  229.  file and go directly to the TWE editor, type a space, then the filename.
  230.  
  231.  F1    = Help, brings up display of available keys
  232.  F2    = Save current edit file, if being watched by TW then scan for
  233.          changes.
  234.  F3    = Load/Create, Load or create another file.
  235.  F4    = Mark   Block, Mark lines of text to copy or delete
  236.  F5    = Copy   Block, Copy Marked lines to cursor
  237.  F6    = Delete Block, Delete Marked Lines
  238.  F7    = Change Editor Colors, Changed the colors of the editor
  239.  F8    = Print File, Print the current edit file to selected printer
  240.  F9    = Show File Change History, Show History file for current edit file
  241.  F10   = Restore Last History Changes, Restore last changes.
  242. Esc    = Exit/Save
  243. Alt-D  = Show current Path
  244. Alt-I  = Information on current file Item, If you are editing your
  245.          WIN.INI or CONFIG.SYS file, place the cursor at the item you wish more
  246.          information on and press the Alt-I keys. Press and hold down the Alt
  247.          key, then press the I key at the same time.
  248.  
  249.          This option may include information on other files such as SYSTEM.INI,
  250.          and AUTOEXEC.BAT in future releases depending on the number of
  251.          registrations and requests for it. You may also create your on info
  252.          file by following the Format and nameing conventions of WIN.HLP or
  253.          CONFIG.HLP files. (ie. WIN.HLP for WIN.INI, CONFIG.HLP for CONFIG.SYS)
  254. Alt-S  = Search and/or Replace text. At the replace prompt press the enter key
  255.          if you on wish to search for text.
  256.  
  257.  
  258.   Distribution Guidelines:
  259.  
  260.   TW may be distributed freely as long as the following guidelines are
  261.   observed:
  262.  
  263.   1) Is distributed with all files in the Original Compressed format and
  264.      no file is modified.
  265.   2) No charge be incurred other than a minimal shipping & handling fee
  266.      not to exceed $10 US dollars
  267.  
  268.  Below is a list of files which should be contained on your Shareware Diskette
  269.  or compressed file.
  270.  
  271.  Files having an * preceding them may be erased if not used, or in the case
  272.  of INSTALL.EXE, after it is used.
  273.  
  274.  Filename        Date    Time    Description
  275.  -------------   ----    ----    --------------------------------------------
  276. *INSTALL.EXE   00-00-80  00:00   Install TW.EXE and TWE.EXE use
  277.  TW.EXE        00-00-80  00:00   Text Watch Command line utility
  278.  TWE.EXE       00-00-80  00:00   Text Watch Editor utility
  279.  EDITOR.HLP    00-00-80  00:00   Text Watch Editor help
  280. *WIN.HLP       00-00-80  00:00   WIN.INI Information on Item Help File
  281. *CONFIG.HLP    00-00-80  00:00   CONFIG.SYS Information on Item Help File
  282. *TWMAN.DOC     00-00-80  00:00   General Information and Directions for use
  283.  REGISTER.DOC  00-00-80  00:00   Your Registration form for Text Watch
  284. *READ.ME       00-00-80  00:00   Last minute update or information
  285. *PRINTREG.BAT  00-00-80  00:00   Print your registration form
  286.  
  287.  For questions or to request customized versions of TW send an EMAIL to Mark
  288.  Vitt CompuServe ID 70053,2236. Complete Manual and Newest Version is available
  289.  to registered users only. See REGISTER.DOC for more information.
  290.  
  291.  This is a Shareware Program - After a 30 day trial you are required either
  292.  to Register your copy or remove it from use on your system. See REGISTER.DOC
  293.  for registration information.
  294.